跳到主要内容

独立经纪商子账户说明

独立经纪商子账户与普通子账户在账户、资产、现货交易和合约交易能力上完全一致。

两者的唯一区别是独立经纪商业务使用不同的统计与返佣归属逻辑,除此之外没有其他功能差异。

本栏目子账户管理接口使用的域名和鉴权规则,请统一参考 基础信息。

交易 API​

现货和合约交易可直接使用普通子账户 API 文档:

备注

不同业务板块的 Base URL 可能不同。调用接口前,请查看对应板块的“基础信息”文档,并以该板块标注的 Base URL 为准。

充提币历史​

独立经纪商子账户统一使用现货账户的充提币历史接口,请参考现有文档:

这两个接口的 currency 和 chain 均为非必填参数。

域名与签名​

独立经纪商子账户相关接口分属三个域名、三套网关,请求前请确认域名与签名方式对应正确。

接口类别生产环境域名说明
现货子账户批量余额https://sapi.xt.com现货域名
合约子账户批量余额https://fapi.xt.com合约域名,路径带 /future/user 前缀
子账户管理 / 充提查询https://api.xt.com用户中心域名

所有接口均需使用独立经纪商母账户的 API Key 签名,仅审核通过的独立经纪商母账户可调用。

请求头:

请求头说明
validate-appkeyAPI Key 的 access key
validate-timestamp毫秒级时间戳
validate-algorithms固定 HmacSHA256
validate-recvwindow请求有效窗口(毫秒),仅现货 / 用户中心接口需要
validate-signatureX + Y 的 HMAC-SHA256 签名值

签名串 X + Y 的拼法因域名而异:

域名X(按参数名字母序)Y
现货 sapi / 用户中心 apivalidate-algorithms=HmacSHA256&validate-appkey=<ak>&validate-recvwindow=5000&validate-timestamp=<ts>#<METHOD>#<path>#<query>(query 按参数名字母序)
合约 fapivalidate-appkey=<ak>&validate-timestamp=<ts>#<path>#<query>(无 METHOD)
备注

合约接口响应结构为 returnCode / msgInfo,现货与用户中心接口为 rc / mc。

子账户数量上限​

一个独立经纪商母账户最高支持 50,000 个子账户,每个子账户最多可创建 10 个 API Key。可通过 查询子账户配额 查看当前使用情况。

错误码​

mc / code说明
AUTH_001未鉴权 / 签名缺失
NO_OPERATION_PERMISSION无权限:非母账户、非审核通过的独立经纪商,或 uid 不属于名下
INVALID_PARAM参数格式错误,如数字参数传非数字、传入不存在的币种
INVALID_TYPE_PARAM / INVALID_STATUS_PARAM / INVALID_DIRECTION_PARAMtype / status / direction 取值非法
WALLET_SERVICE_UNAVAILABLE钱包服务暂不可用